home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat3 / Tk / canvpsy.z / canvpsy
Encoding:
Text File  |  1998-10-30  |  9.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4. TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssYYYY((((3333TTTTkkkk))))                                            TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssYYYY((((3333TTTTkkkk))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      Tk_CanvasPsY, Tk_CanvasPsBitmap, Tk_CanvasPsColor, Tk_CanvasPsFont,
  10.      Tk_CanvasPsPath, Tk_CanvasPsStipple - utility procedures for generating
  11.      Postscript for canvases
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
  15.  
  16.      double
  17.      TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssYYYY(_c_a_n_v_a_s, _c_a_n_v_a_s_Y)
  18.  
  19.      int
  20.      TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssBBBBiiiittttmmmmaaaapppp(_i_n_t_e_r_p, _c_a_n_v_a_s, _b_i_t_m_a_p, _x, _y, _w_i_d_t_h, _h_e_i_g_h_t)
  21.  
  22.      int
  23.      TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssCCCCoooolllloooorrrr(_i_n_t_e_r_p, _c_a_n_v_a_s, _c_o_l_o_r_P_t_r)
  24.  
  25.      int
  26.      TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssFFFFoooonnnntttt(_i_n_t_e_r_p, _c_a_n_v_a_s, _f_o_n_t_S_t_r_u_c_t_P_t_r)
  27.  
  28.      TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssPPPPaaaatttthhhh(_i_n_t_e_r_p, _c_a_n_v_a_s, _c_o_o_r_d_P_t_r, _n_u_m_P_o_i_n_t_s)
  29.  
  30.      int
  31.      TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssSSSSttttiiiipppppppplllleeee(_i_n_t_e_r_p, _c_a_n_v_a_s, _b_i_t_m_a_p)
  32.  
  33. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  34.      Tk_Canvas      _c_a_n_v_a_s           (in)      A token that identifies a
  35.                                                canvas widget for which
  36.                                                Postscript is being generated.
  37.  
  38.      double         _c_a_n_v_a_s_Y          (in)      Y-coordinate in the space of
  39.                                                the canvas.
  40.  
  41.      Tcl_Interp     *_i_n_t_e_r_p          (in/out)  A Tcl interpreter;  Postscript
  42.                                                is appended to its result, or
  43.                                                the result may be replaced with
  44.                                                an error message.
  45.  
  46.      Pixmap         _b_i_t_m_a_p           (in)      Bitmap to use for generating
  47.                                                Postscript.
  48.  
  49.      int            _x                (in)      X-coordinate within _b_i_t_m_a_p of
  50.                                                left edge of region to output.
  51.  
  52.      int            _y                (in)      Y-coordinate within _b_i_t_m_a_p of
  53.                                                top edge of region to output.
  54.  
  55.      int            _w_i_d_t_h            (in)      Width of region of bitmap to
  56.                                                output, in pixels.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssYYYY((((3333TTTTkkkk))))                                            TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssYYYY((((3333TTTTkkkk))))
  71.  
  72.  
  73.  
  74.      int            _h_e_i_g_h_t           (in)      Height of region of bitmap to
  75.                                                output, in pixels.
  76.  
  77.      XColor         *_c_o_l_o_r_P_t_r        (in)      Information about color value
  78.                                                to set in Postscript.
  79.  
  80.      XFontStruct    *_f_o_n_t_S_t_r_u_c_t_P_t_r   (in)      Font for which Postscript is to
  81.                                                be generated.
  82.  
  83.      double         *_c_o_o_r_d_P_t_r        (in)      Pointer to an array of
  84.                                                coordinates for one or more
  85.                                                points specified in canvas
  86.                                                coordinates.  The order of
  87.                                                values in _c_o_o_r_d_P_t_r is x1, y1,
  88.                                                x2, y2, x3, y3, and so on.
  89.  
  90.      int            _n_u_m_P_o_i_n_t_s        (in)      Number of points at _c_o_o_r_d_P_t_r.
  91.  
  92.  
  93.  
  94. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  95.      These procedures are called by canvas type managers to carry out common
  96.      functions related to generating Postscript.  Most of the procedures take
  97.      a _c_a_n_v_a_s argument, which refers to a canvas widget for which Postscript
  98.      is being generated.
  99.  
  100.      TTTTkkkk____CCCCaaaannnnvvvvaaaassssYYYY takes as argument a y-coordinate in the space of a canvas and
  101.      returns the value that should be used for that point in the Postscript
  102.      currently being generated for _c_a_n_v_a_s.  Y coordinates require
  103.      transformation because Postscript uses an origin at the lower-left corner
  104.      whereas X uses an origin at the upper-left corner.  Canvas x coordinates
  105.      can be used directly in Postscript without transformation.
  106.  
  107.      TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssBBBBiiiittttmmmmaaaapppp generates Postscript to describe a region of a bitmap.
  108.      The Postscript is generated in proper image data format for Postscript,
  109.      i.e., as data between angle brackets, one bit per pixel.  The Postscript
  110.      is appended to _i_n_t_e_r_p->_r_e_s_u_l_t and TCL_OK is returned unless an error
  111.      occurs, in which case TCL_ERROR is returned and _i_n_t_e_r_p->_r_e_s_u_l_t is
  112.      overwritten with an error message.
  113.  
  114.      TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssCCCCoooolllloooorrrr generates Postscript to set the current color to
  115.      correspond to its _c_o_l_o_r_P_t_r argument, taking into account any color map
  116.      specified in the ppppoooossssttttssssccccrrrriiiipppptttt command.  It appends the Postscript to
  117.      _i_n_t_e_r_p->_r_e_s_u_l_t and returns TCL_OK unless an error occurs, in which case
  118.      TCL_ERROR is returned and _i_n_t_e_r_p->_r_e_s_u_l_t is overwritten with an error
  119.      message.
  120.  
  121.      TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssFFFFoooonnnntttt generates Postscript that sets the current font to match
  122.      _f_o_n_t_S_t_r_u_c_t_P_t_r as closely as possible.  TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssFFFFoooonnnntttt takes into account
  123.      any font map specified in the ppppoooossssttttssssccccrrrriiiipppptttt command, and it does the best it
  124.      can at mapping X fonts to Postscript fonts.  It appends the Postscript to
  125.      _i_n_t_e_r_p->_r_e_s_u_l_t and returns TCL_OK unless an error occurs, in which case
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssYYYY((((3333TTTTkkkk))))                                            TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssYYYY((((3333TTTTkkkk))))
  137.  
  138.  
  139.  
  140.      TCL_ERROR is returned and _i_n_t_e_r_p->_r_e_s_u_l_t is overwritten with an error
  141.      message.
  142.  
  143.      TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssPPPPaaaatttthhhh generates Postscript to set the current path to the set
  144.      of points given by _c_o_o_r_d_P_t_r and _n_u_m_P_o_i_n_t_s.  It appends the resulting
  145.      Postscript to _i_n_t_e_r_p->_r_e_s_u_l_t.
  146.  
  147.      TTTTkkkk____CCCCaaaannnnvvvvaaaassssPPPPssssSSSSttttiiiipppppppplllleeee generates Postscript that will fill the current path
  148.      in stippled fashion.  It uses _b_i_t_m_a_p as the stipple pattern and the
  149.      current Postscript color;  ones in the stipple bitmap are drawn in the
  150.      current color, and zeroes are not drawn at all.  The Postscript is
  151.      appended to _i_n_t_e_r_p->_r_e_s_u_l_t and TCL_OK is returned, unless an error
  152.      occurs, in which case TCL_ERROR is returned and _i_n_t_e_r_p->_r_e_s_u_l_t is
  153.      overwritten with an error message.
  154.  
  155.  
  156. KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  157.      bitmap, canvas, color, font, path, Postscript, stipple
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.